home *** CD-ROM | disk | FTP | other *** search
/ Amiga Collections: Auge 4000 / Auge 4000 #47 (1990-06-22)(Amiga User Gruppe Einzugsgebiet 4000).zip / Auge 4000 #47 (1990-06-22)(Amiga User Gruppe Einzugsgebiet 4000).adf / arp-pro1.3 / NEW_MANUAL / ArpAllocFreq < prev    next >
Text File  |  1990-06-22  |  2KB  |  64 lines
  1.  
  2.  
  3.  
  4.      ArpAllocFreq(39.0)   ARP Programmers Manual    ArpAllocFreq(39.0)
  5.  
  6.  
  7.      NAME
  8.     ArpAllocFreq - Create an initialized FileRequester structure.
  9.  
  10.      SYNOPSIS
  11.       FileRequester = ArpAllocFreq( )
  12.         d0
  13.  
  14.      FUNCTION
  15.       This function allocates a "FileRequester" data structure
  16.       which has been initialized to include optimized default
  17.       values for the FileRequest() function.
  18.       
  19.       For compatability with future versions of arp.library,
  20.       it is recommended to use the ArpAllocFreq() function rather
  21.       than creating your own FileRequester data structures.
  22.  
  23.     INPUTS
  24.        None.
  25.  
  26.      RESULT
  27.       FileRequester - Pointer to a struct FileRequester as used
  28.           in the ARP FileRequest() function.
  29.           
  30.           The fr_Dir and fr_File fields will contain string
  31.           pointers to allocated buffers.  DO NOT ALTER these
  32.           values.  It is safe to use the TackOn function to
  33.           concatenate the fr_File field into the fr_Dir field,
  34.           and then use BaseName to separate the filename from
  35.           the path substring.  The buffers will allow at least
  36.           FCHARS bytes in each string.  Do not assume more.
  37.  
  38.           DO NOT alter any fr_FuncFlags values except by ORing
  39.           in new flag values.  ArpAllocFreq will initialized
  40.           flag values which must not be altered to assure
  41.           upwardly compatible operation.
  42.  
  43.       TRACKER - pointer to the resource tracking node.  This value
  44.             is only returned on a sucessful open.  The value is
  45.             returned in register A1 for assembly, or via the
  46.             defined function "LASTTRACKER" in C.
  47.  
  48.      REMEMBER
  49.       You must call    FreeTrackedItem(TRACKER), ArpExit() or
  50.       CloseLibrary(ArpLib) to free this resource.
  51.  
  52.      BUGS
  53.       None known.
  54.  
  55.      SEE ALSO
  56.       FileRequest(), FreeTrackedItem(), ArpExit(),
  57.       Arpbase.h for LASTTRACKER
  58.  
  59.      AUTHOR
  60.       CDH
  61.  
  62.  
  63.    Page 1                         (printed 9/12/89)
  64.